Disposes of the memory occupied by a search criteria reference.

OSStatus KCReleaseSearch (
    KCSearchRef *search
);

search

A pointer to a search criteria reference. Pass the search criteria reference whose memory you want to release. On return, the reference is set to NULL and should not be used again.

function result

A result code. The result code errKCInvalidSearchRef indicates that the specified search reference was invalid.

DISCUSSION

You should call the KCReleaseSearch function to release the memory occupied by a search criteria reference when you are completely finished with a search performed by calling the functions KCFindFirstItem or KCFindNextItem.

VERSION NOTES

Available beginning with Keychain Manager 1.0

AVAILABILITY

Under evaluation for Carbon. Available in CarbonLib 1.0 and later when KeychainLib 1.0 or later is installed. Exported by CarbonLib 1.0 and later and by KeychainLib 1.0 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)